docs: reorg — dev-setup guide + concise staging plan + archive cleanup#53
Merged
hanwencheng merged 1 commit intomainfrom Apr 23, 2026
Merged
docs: reorg — dev-setup guide + concise staging plan + archive cleanup#53hanwencheng merged 1 commit intomainfrom
hanwencheng merged 1 commit intomainfrom
Conversation
Replaces the 1623-line stage-by-stage history with a Shipped / Active /
Planned summary; adds a single CDP-only dev-setup + demo guide;
archives the drifted manual-test-*.md per-issue files and the
Gmail-backed demo variants.
- `docs/spec/plans/development-stages.md` — rewritten (~180 lines).
Shipped: Stages 0-5a + 6 (interim) each as one-line summaries.
Active: Stage 5b telemetry + LLM-fallback plan, Stage 6 finalization.
Planned: Stage 7 OIDC, Stage 8 Priority A, npm packaging.
- `docs/dev-setup.md` — CDP-only onboarding guide. Prereqs → build →
Stage 6 env → OpenRouter demo → OpenAI demo → verify → troubleshoot.
Explicitly dismisses the Gmail demo variant (archived).
- `docs/archived/` — 13 files moved (development-stages v1, four
manual-test-stage{4,5,6} / stage5-workspace-email-setup, and the
eight per-issue manual-test-issue-1X.md + report). README.md spells
out the supersession mapping + archive policy.
- `.gitignore` — block Stage 6 one-shot JSON artifacts from creeping
back (`bucket-policy*.json`, `daemon-user-inline.json`,
`dns-change.json`, `probe*.mjs`) per CLAUDE.md's jq-only rule; ignore
the double-nested `provisioner-scripts/provisioner-scripts/` tsx
cwd artifact.
- `CLAUDE.md` — keep the "do not read folder docs/archived" hint.
Follow-up to #52. No runtime code changes; docs + gitignore only.
hanwencheng
force-pushed
the
docs/reorg-dev-onboarding
branch
from
3a09e83 to
557d901
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Follow-up to #52. No runtime code changes — docs +
.gitignoreonly.docs/spec/plans/development-stages.md— rewritten from 1623 lines of full per-stage history into ~180 lines organized as Shipped / Active / Planned. Full v1 preserved atdocs/archived/development-stages-v1-2026-04.md.docs/dev-setup.md— new single-source dev onboarding + demo guide. CDP-only (OpenRouter + OpenAI); the Gmail-backed demo variant is explicitly dismissed and archived.docs/archived/(13 files moved +README.md) — supersession mapping + archive policy. Covers the old development-stages, themanual-test-stage{4,5,6}.mdfiles,stage5-workspace-email-setup.md, and the eight per-issue manual-test files from the Stage 4 campaign..gitignore— blocks Stage 6 one-shot JSON artifacts from creeping back in (bucket-policy*.json,daemon-user-inline.json,dns-change.json,probe*.mjs) perCLAUDE.md's "usejq -n --argpiped straight into the CLI, never heredoc JSON" rule; plus the double-nestedprovisioner-scripts/provisioner-scripts/tsx-cwd artifact.CLAUDE.md— keeps the one-line "do not read folderdocs/archived" hint so future sessions skip the archive by default.Rationale
bucket-policy.json/daemon-user-inline.json/dns-change.jsonkept re-appearing because operators followed old heredoc patterns. One of them even had the zsh modifier bug baked in (429071895007ole— missing:rexpansion)..gitignorenow refuses to let them back.Test plan
cargo build --workspace --release— unchanged (no code touched)cargo test --workspace— unchanged (no code touched)docs/dev-setup.mdresolve to existing files in-repodocs/spec/plans/development-stages.mdresolvegrep -r gmail docs/dev-setup.md docs/spec/plans/development-stages.mdreturns only the "archived Gmail-backed variants" pointer in the introdocs/archived/README.mdcovers every moved fileOut of scope
~/.claude/plans/an-agentkey-user-could-streamed-meteor.md, lands in a separate PR once telemetry substrate is ready.heima-gaps §3.🤖 Generated with Claude Code